home *** CD-ROM | disk | FTP | other *** search
/ Mac Mania 2 / MacMania 2.toast / Demo's / Tools&Utilities / QCat 1.4.3 / QCat 1.4.3 Dox.txt < prev    next >
Encoding:
Text File  |  1991-03-20  |  8.4 KB  |  262 lines  |  [TEXT/MACA]
  1. QCat V 1.4.3
  2. by
  3. Richard De Luca
  4.  
  5. 3/22/91
  6.  
  7. All rights reserved.
  8.  
  9. GEnie: M.BUSSIERES
  10. CompuServe: 72567,3634
  11.  
  12. If you own a Mac and need to use this program then surely you can afford to
  13. send only $15.00 to:
  14.  
  15.     Richard De Luca
  16.     501 Chemin Witty
  17.     Ste-Christine, Qc Canada
  18.     J0H 1H0
  19.  
  20. Thank you for your support!
  21.  
  22. • What it is.
  23.  
  24. “QCat” is a utility for cataloguing disks.  It creates a  “TEXT” file
  25. that can be imported into any database program that supports it.  It
  26. can also be searched by any program that allows searches into text
  27. files.
  28.  
  29. Network volumes are NOT yet supported.
  30.  
  31. This version is MultiFinder compatible, but for better performance I
  32. suggest using it from the Finder.
  33.  
  34. Although easy to use, a little effort from the user is required to keep
  35. the catalog up to date.  When you need that “I know I've got it but
  36. where is it?” file you will find it very much worth your while.
  37.  
  38. To set up a database, the provided fields, in order, are:
  39.  
  40.     File Name
  41.     Version (Optional)
  42.     Visible
  43.     Type
  44.     Creator
  45.     Size
  46.     File ID
  47.     Creation Date
  48.     Last Modification
  49.     Path
  50.  
  51. If you have Hyper Card, you can use the stacks supplied with this file
  52. to get started.
  53.  
  54. I hope “QCat” will be as useful to you as it is to me.
  55.  
  56. • The Commands.
  57.  
  58. ◊ Action Menu    
  59.  
  60. The cataloguing processes can be aborted by clicking on the “Stop”
  61. button that appears in the lower right main window.
  62.  
  63. Catalog -> Floppies    Command+F
  64.  
  65. Brings up the “standard” Open File Dialog which lets you open an
  66. existing Catalog File, or create a new one by clicking on the “New…”
  67. button or <Option+Command+N>. This weird combination is used to
  68. prevent interference with other utilities like “Boomerang”.
  69.  
  70. If you create a new file then the standard Save File Dialog  appears
  71. with a file name included and selected.
  72.  
  73. I won't bore you with the details of how to use the standard file
  74. dialogs.
  75.  
  76. Then, just feed floppies in any drive until you're done.
  77.  
  78. Catalog -> Hard Disks    Command+H
  79.  
  80. Brings up a dialog with a list of all available Hard Disks.  You can
  81. use the “Catalog” button or double click on the item you want
  82. catalogued. For the rest see “Catalog Floppy Disks” above.
  83.  
  84. Catalog -> Removable    Command+R
  85.  
  86. NOTE:    This feature was implemented without the actual use of a
  87. removable. It was tried once with a PLI 45MB SyQuest cartridge
  88. and seemed to work fine. Notices of success or failure will be
  89. appreciated.
  90.  
  91. Brings up a dialog with a list of all available Removables.  You can
  92. use the “Catalog” button or double click on the item you want
  93. catalogued. For the rest see “Catalog Floppy Disks” above.
  94.  
  95. See “Another (Hard Disk/Removable)” below for “Mount” and
  96. “Unmount” instructions.
  97.  
  98. Catalog -> Masters    Command+M
  99.  
  100. My rule #1 : Masters should ALWAYS remain locked.
  101.  
  102. This feature allows you to serialize master floppies without actually
  103. modifying the disk.
  104.  
  105. Just specify a starting number in the dialog. “QCat” will insert a
  106. serial number in the “Path” field of the catalog.
  107.  
  108. Cataloguing “My Master 1” , “My Master 2” , “My Master 3” with a
  109. starting number of “129” will produce “My Master 1\129” , “My
  110. Master 2 \130 ” , “My Master 3 \131 ” for disk names in the catalog
  111. but the actual disk name remains unchanged. An example file path
  112. would be: “Master 2 \130:Folder 1:Folder 2:…”
  113.  
  114. Place a sticker with those numbers or write them on the disks, and
  115. store them in that order. It will now be very easy to locate any
  116. catalogued file. 
  117.  
  118. Another (Hard Disk/Removable) Command+N
  119.  
  120. Usually dimmed, this choice is available only after a hard disk or
  121. removable has been catalogued.  Selecting it lets you choose and
  122. catalog another Hard Disk/Removable to the current catalog file.
  123.  
  124. To swap removables, select the one to eject and click on “Unmount”,
  125. remove it and insert another one. When ready, (follow your hardware
  126. instructions ie: wait for green light) click on the “Mount” button.
  127. When it appears in the list, select it and click on “Catalog” or double
  128. click on it. Please keep in mind the note on removables above.
  129.  
  130. Done    Command+.
  131.  
  132. When you're done with a catalog file, this command closes it, you can
  133. then open another one or quit.
  134.  
  135. ◊ Options Menu    
  136.  
  137. Include Header    Command+1
  138.  
  139. This command lets you include the field names as the first record in
  140. a catalog file. The state of this option is saved at quitting and will
  141. be in effect at your next session.
  142.  
  143. Include Version    Command+2
  144.  
  145. As of “QCat 1.3”, you now have the option to include the version in
  146. your catalog. Works only for files that comply with Apple guidelines
  147. and include a “vers ID# 1” resource. It is optional because it can
  148. slow down the process. The state of this option is saved at quitting
  149. and will be in effect at your next session.
  150.  
  151. Set Creator    Command+3
  152.  
  153. This command lets you specify the “TEXT” file Creator (eg: MacWrite
  154. = MACA, Edit = EDIT, etc.).
  155.  
  156.  
  157. If you don't know the creator you want, use the “Get…” button. In the
  158. Standard Open File Dialog, select the application or document you want as 
  159. creator of your catalog file.  You'll then be able to open this file from 
  160. the Finder by double clicking on its icon.  If you use the “Save as default”
  161. check box, it will become the default creator and you won't need to
  162. set it again for future sessions.
  163.  
  164. Set Delimiters    Command+4
  165.  
  166. This command lets you specify the characters that separate fields
  167. and records in the catalog file.  Most databases support the import of
  168. files using a tab character (ASCII 9) between fields and a carriage
  169. return (ASCII 13) to separate records, this is the default setting. 
  170. For custom applications or programs in “BASIC”, who use a
  171. comma to separate fields, you can change this.
  172.  
  173. The common choices are available as radio buttons but you can set
  174. any character you want by clicking the “Other” button, just type in the
  175. character from the keyboard (eg:“/”,“;”,“-”,etc.), or the “ASCII”
  176. button, you type in the ASCII code of the character you want (eg: code
  177. 59 for semicolon, code 36 for the dollar sign, etc.).
  178.  
  179. You may get unwanted results if you use the “Colon” ( “:” , ASCII 58
  180. ), “QCat” uses it to separate the folder names in the “Path” field. 
  181. The “Space” ( ASCII 32 ) character is not such a good idea either.
  182.  
  183. If you use the “Save as default” check box, these settings will be
  184. kept as the defaults for future sessions.
  185.  
  186. Filter    Command+5
  187.  
  188. This command lets you filter, in or out, some types of files.
  189.  
  190. Selecting an option, will include it in the catalog.  Deselecting an
  191. option will exclude it.  The following options are available: Folders,
  192. Applications, Desktop files, System files, Invisible files and All
  193. Others. 
  194.  
  195. If “Folders” is selected, two passes are required to calculate the
  196. “Size” field for folders, performance is thus impaired.
  197.  
  198. As usual, the “Save as default” option lets you keep those settings
  199. for future sessions.
  200.  
  201. Serialize    Command+6
  202.  
  203. This option lets you serialize your floppy disks as they are
  204. catalogued. Disks must be unlocked to serialize.
  205.  
  206. WARNING: This operation changes the name of the disk.
  207.  
  208.     eg: “myFloppy”  becomes “56\myFloppy”.
  209.  
  210. You can choose to continue from the last session or set a new
  211. starting number. The state of this option is saved at quitting and will
  212. be in effect at your next session.
  213.  
  214. If you're serializing, and insert a locked disk, a dialog will prompt
  215. you for the action to take.
  216.  
  217. If you choose “Unlock and Serialize”, the disk is ejected for you to
  218. unlock and reinsert. Choosing “Don't Serialize”, the disk will be
  219. catalogued normally but not serialized. “Don't Catalog” simply ejects
  220. the disk.
  221.  
  222. I suggest you NOT serialize original master disks since the operation
  223. writes to the disk to change its name. Use “Don't Serialize”. See
  224. “Catalog->Masters” above.
  225.  
  226. Log Free Space    Command+7
  227.  
  228. When this option is selected, an extra file is created in witch the
  229. disk name and free space is logged. The state of this option is saved
  230. at quitting and will be in effect at your next session.
  231.  
  232. Defaults    Command+8
  233.  
  234. This command lets you cancel all setting changes and revert to the
  235. default settings. If you've used the “Save as default” option, the
  236. changes will be kept.
  237.  
  238. ◊ File Menu    
  239.  
  240. Show/Hide Settings    Command+S
  241.  
  242. Show or hide the settings window. When visible, settings can be
  243. changed by clicking on an item.
  244.  
  245. The state of this option is saved at quitting and will be in effect at
  246. your next session.
  247.  
  248. Save Settings…    
  249.  
  250. Brings up the standard Save File Dialog. Lets you name and save
  251. current settings for future use. Double clicking a setting file, in the
  252. Finder, launches “QCat” and installs the saved settings.
  253.  
  254. Load Settings…
  255.  
  256. Brings up the standard Open File Dialog. To install saved settings,
  257. select and open a settings file.
  258.  
  259. Quit    Command+Q
  260.  
  261. Well, what can I say?
  262.